home *** CD-ROM | disk | FTP | other *** search
/ ftp.hypersurf.com / ftp.hypersurf.com.tar / ftp.hypersurf.com / pub / mac / chat / PalaceUserPPC.hqx / PalaceInstall_PPC_3.0.1 / Read Me < prev    next >
Text File  |  1999-02-18  |  11KB  |  295 lines
  1. =======================================
  2. The Palace¬
  3. Macintosh Client v3.0.1 Release Notes
  4. February 1999
  5. =======================================
  6.  
  7.  
  8. Contents
  9. ============
  10.     System Requirements
  11.     Installation
  12.     What's new?
  13.     Bookmarks Menu
  14.     InternetConfig Support
  15.     MIDI support via InternetConfig
  16.     Modified Connection Dialog
  17.     Corrupt prop reporting
  18.     Out of Memory Errors
  19.     Firewalls
  20.     Contact Information
  21.  
  22.  
  23. System Requirements
  24. ====================
  25.  
  26. Minimum:
  27. System 7.1+ 
  28. 5 MB of available RAM 
  29. Connection to the Internet 
  30. 256 colors (8 bit) 
  31. 640x480+ support 
  32.  
  33.  
  34. Recommended:
  35. Minimum plus
  36. System 7.6.1 or later
  37. 6 MB of available RAM or greater
  38. 1024x768 screen resolution or greater
  39. QuickTime 3.0 or greater
  40.  
  41.  
  42. Installation
  43. =============
  44.  
  45. Upgrading from a previous version:
  46.  
  47. - Run The Palace installer.
  48. - Select Custom install and choose Upgrade.
  49. - Select the location of the folder to install to and verify the installed folder
  50.      name.  You may need to change the name of the install folder in the dialog.
  51. - Select OK and the installer will upgrade The Palace installation for you.
  52. - The installer will upgrade only the necessary files.
  53.      Your props, preferences and Cyborg.ipt file will be untouched.
  54.  
  55. We recommend you move your Palace Preferences and Palace Registration file from
  56. System Folder:Preferences to The Palace folder if they are not already located there.
  57.  
  58. Full Install:  Double Click the installer and select the location for the new
  59. The Palace Folder.
  60.  
  61. InternetConfig v2.0.2 is installed.  Refer to it's included documentation for setup
  62. instructions.  Additional instructions specific to use with The Palace are available
  63. in the documentation available at:
  64. http://www.thepalace.com/support/manuals/mac/Output/macclientTOC.html
  65.  
  66.  
  67. What's new?
  68. ============
  69.  
  70.     - Fixed crash some users experienced when opening windows
  71.     - Fixed a hang on failed connection attempts
  72.     - Prop Picker window is resizable
  73.     - Window positions are saved and used switching to and from Full Screen mode
  74.     - Connection dialog now takes host/port in same field
  75.     - Macro Menu is now called Avatars to accurately reflect it's purpose
  76.     - Bookmarks menu added
  77.     - InternetConfig now fully supported
  78.     - Memory leaks plugged, improving stability with stock RAM allocation
  79.     - Clicking on splash screen will log on to top palace in Connection dialog
  80.     - Support for announcements and advertisements
  81.     - PalacePresents updated to work with The Palace for Macintosh v3.0 and later
  82.     
  83.     
  84. Bookmarks
  85. ============
  86.  
  87. By default, the Palace bookmarks file is installed in The Palace folder.  Should
  88. this file be lost for some reason, the program will create an empty file in
  89. System Folder:Preferences.  It can be moved to The Palace application folder
  90. (like The Palace Preferences file).  This is recommended for easy access to the
  91. file and to allow different users to use different bookmarks/preferences with
  92. different The Palace folders.
  93.  
  94. You can save a bookmark when you are connected to a server.  Select Save Bookmark
  95. from the Bookmarks menu.  That server's connection information will be saved and
  96. available with the bookmarks menu.
  97.  
  98. While it is possible to edit The Palace Bookmarks file, it is not recommended.
  99. The file format is name,tab and the fully qualified URL of the server (including
  100. port).  The file must end on an empty line (return after your last entry).
  101.  
  102. Examples:
  103.  
  104. My Favorite Palace    palace://palace.coolplace.com:9998
  105. My Home Page    http://www.mywebsite.com/neatstuff/start.html
  106.  
  107.  
  108. InternetConfig
  109. ===============
  110.  
  111. The Palace for Macintosh v3.0 fully supports InternetConfig.  This will
  112. intercept URLs and pass them to the appropriate helper application, such as
  113. Internet Explorer for a web page if you chose IE as your web browser in the
  114. InternetConfig setup.  It will also call helper applications for files such
  115. as .mid.  This feature brings a great deal of power to the Macintosh client.
  116. We only touch on a few examples here.
  117.  
  118. InternetConfig is a public domain application and was not developed by
  119. The Palace¬, Inc.  More information about InternetConfig can be found at:
  120.  
  121. http://www.quinn.echidna.id.au/Quinn/Config/
  122. -or-
  123. http://www.stairways.com/ic/
  124.  
  125. Many applications support InternetConfig and the latest release (2.0.2 as of
  126. this writing) is compatible with MacOS 8.5.1.
  127.  
  128.  
  129. MIDI Support
  130. ===============
  131.  
  132. You can set up InternetConfig to have .mid and .midi files routed
  133. to an application such as SoundApp.  Then, you can type ")titanic.mid" and 
  134. if it is in your Media folder, it will play in SoundApp.  You can also use
  135. the SOUND command to retrieve and/or play files in this manner.  This can 
  136. be done via room scripts or command line (/"titanic.mid" SOUND).
  137.  
  138. More information on SoundApp can be found at:
  139. http://www-cs-students.stanford.edu/~franke/SoundApp/
  140.  
  141.  
  142. The MMMMM plugin (developed by Ken Marks) should still function, although the
  143. client does not recognize the MMMMM script style.  Should you desire to continue
  144. to use that format, you will need to leave the MMMMM plugin and accessories
  145. installed.
  146.  
  147. The features in this revision bring the compatibility between the Macintosh
  148. and PC client almost even.  MIDIPLAY and MIDISTOP iptscrae commands are not
  149. recognized by this revision.
  150.  
  151. In order to provide and script MIDI for The Palace users on both Macintosh and PC, 
  152. we recommend that you provide an archive for users to download.  The current
  153. version of the PC client (3.4.1) is incapable of downloading MIDI files with
  154. a .mid extension.  To script a single command that works for both Mac and PC,
  155. either ")filename.mid" SAY or "filename.mid" SOUND will work.  Users of either
  156. platform may just type )filename.mid to play a midi, just like with any normal
  157. sound file.  This provides an almost seamless integration between the two
  158. platforms.
  159.  
  160. MIDI files are only one new type that The Palace can now utilize due to the
  161. addition of InternetConfig support.  MP3 files, RealAudio¬, QuickTime¬ movies and
  162. many more can now be used in The Palace for Macintosh v3.0.
  163.  
  164.  
  165. Connection Dialog
  166. ==================
  167.  
  168. The connection dialog has been changed and the entry field for the port has 
  169. been eliminated.  The port should now be part of the hostname you enter, such
  170. as:  palace.thepalace.com:9998
  171.  
  172. In that example, 9998 is the port number.  This change was made to conform to
  173. how people normally mention a site's address.
  174.  
  175.  
  176. Corrupt Prop Reporting
  177. =======================
  178.  
  179. You may get a log message indicating a prop is corrupt and will not be accepted
  180. by the server.  This is not a bug.  The server has rejected your prop because 
  181. the prop data failed to pass a data integrity check.  This new Macintosh client
  182. now responds to these server rejections by informing you.
  183.  
  184. Unfortunately, there are alot of corrupt props out on the net and you could have
  185. many in your prop bag. The best way to deal with this is to delete the affected
  186. prop(s).  There are other, more unreliable methods of handling this in an attempt
  187. to save a corrupt prop.  You can rename the prop or edit one pixel of that prop.
  188. You can copy the prop in the prop editor and paste that into a NEW prop.
  189. Depending on the extent of corruption, these other options may or may not work
  190. for you.
  191.  
  192. Other users will not be able to see a corrupted prop, unless they have seen
  193. the prop previously prior to it becoming corrupted (meaning it is cached).
  194. The intent of these checks is to reduce prop corruption and propagation amongst
  195. The Palace users.  You should not let the red log messages alarm you.  
  196.  
  197.  
  198. Out of Memory Errors
  199. =====================
  200.  
  201. Users in heavy prop traffic areas or viewing large prop files used to occasionally
  202. experience an out of memory (Type 25) error.  This was due to a memory leak in the
  203. prop management code.  Virtually all of these leaks have been fixed.  You can 
  204. now happily click through HUGE prop files without crashing due to memory errors.  It
  205. should no longer be necessary to increase the RAM allocated to The Palace application
  206. to compensate for this old problem.  The only reason to increase the RAM allocation
  207. to The Palace client to to allow large WAVE files to play (over 2 megs in size) or
  208. to handle rooms with multiple large spot pictures.
  209.  
  210.  
  211. Behind a Firewall?
  212. ===================
  213.  
  214. If your computer is running on a corporate LAN inside a firewall, you might not
  215. be able to connect to The Palace sites outside the LAN unless your network
  216. administrator changes the firewall configuration. This section describes the
  217. necessary firewall changes. 
  218.  
  219. If you have problems connecting, show this section to your network administrator.
  220.  
  221. Two firewall changes are necessary to allow The Palace users inside the firewall
  222. to connect to servers outside:
  223.  
  224. 1.  Permit TCP/IP connections on a particular port (usually 9998).
  225.  
  226. 2.  Permit incoming packets on that same port over established connections.
  227.  
  228. Descriptions follow.
  229.  
  230.  
  231. Permitting TCP/IP Connections over a Port
  232.  
  233. The Palace software uses TCP/IP to establish a reliable connection to a The Palace¬
  234. server that is listening on a particular port. When you use the software to
  235. connect, you specify the name of the server (such as thepalace.com) and the
  236. port (usually 9998). The port can vary from server to server, but most use the 
  237. default port of 9998. The software then sends a TCP/IP connection established
  238. message over that port to the server.
  239.  
  240. However, firewalls often prevent communication over all but a few well-known
  241. ports. Therefore, to allow The Palace software to make contact with servers, the 
  242. network administrator must configure the firewall to permit internal workstations
  243. to establish TCP/IP connections on the specific port (usually 9998).
  244.  
  245.  
  246. Permitting Incoming Packets Over the Same Port
  247.  
  248. Once The Palace software establishes a connection to the server, the software
  249. and server send packets back and forth over The Palace port (again, usually 9998). 
  250. However, firewalls often prevent incoming packets from other than well-known
  251. ports.  Therefore, the network administrator must configure the firewall to
  252. permit incoming packets over the specific port (usually 9998) on established
  253. connections.
  254.  
  255. The key to permitting incoming packets is that the firewall should not allow
  256. them except when the connection has already been established by an internal 
  257. workstation. This minimizes the security risk of hackers trying to break into the
  258. LAN, because someone inside must establish the connection first.
  259.  
  260. In addition, the firewall must be configured to allow outgoing packets over the
  261. specific port on established connections. However, this usually happens as a
  262. result of permitting TCP/IP connections over the port.
  263.  
  264. NOTE: In LANs where workstations are not directly connected to the firewall but
  265. instead are connected to a proxy, the network administrator might need to perform
  266. additional configuration steps to allow packets through on these ports.
  267.  
  268.  
  269. Contact Information 
  270. ====================
  271.  
  272.   The Palace, Inc.
  273.   10101 N. DeAnza Blvd.
  274.   Suite 100
  275.   Cupertino, CA  95014
  276.  
  277.   Phone: (408) 342-9500 
  278.   Fax:   (408) 777-9200
  279.   http://www.thepalace.com 
  280.  
  281.  
  282. Technical Support
  283. ==================
  284.  
  285. If you have technical support questions, or if you want 
  286. to browse the FAQs or online manuals, post questions to 
  287. The Palace discussion groups, or send feedback about the 
  288. product, point your web browser to:
  289.  
  290.    http://www.thepalace.com/support/
  291.  
  292.  
  293.  
  294.  
  295.